package com.cargohu.aishouyu.operation.service;

import com.cargohu.aishouyu.framework.page.Paging;
import com.cargohu.aishouyu.framework.service.BaseService;
import com.cargohu.aishouyu.operation.dto.AppNoticeAddDTO;
import com.cargohu.aishouyu.operation.dto.AppNoticeUpdateDTO;
import com.cargohu.aishouyu.operation.entity.AppNotice;
import com.cargohu.aishouyu.operation.req.AppNoticeRequest;
import com.cargohu.aishouyu.operation.resp.AppNoticeDetailVo;
import com.cargohu.aishouyu.operation.resp.AppNoticeResponse;

/**
 * APP公告 服务接口
 *
 * @author yww
 * @since 2023-11-29
 */
public interface AppNoticeService extends BaseService<AppNotice> {

    /**
     * 添加APP公告
     *
     * @param appNoticeAddDTO
     * @return
     * @throws Exception
     */
    boolean addAppNotice(AppNoticeAddDTO appNoticeAddDTO) throws Exception;

    /**
     * 修改APP公告
     *
     * @param appNoticeUpdateDTO
     * @return
     * @throws Exception
     */
    boolean updateAppNotice(AppNoticeUpdateDTO appNoticeUpdateDTO) throws Exception;

    /**
     * 删除APP公告
     *
     * @param id
     * @return
     * @throws Exception
     */
    boolean deleteAppNotice(Long id) throws Exception;

    /**
     * APP公告详情
     *
     * @param id
     * @return
     * @throws Exception
     */
    AppNoticeDetailVo getAppNoticeById(Long id) throws Exception;

    /**
     * APP最新公告详情
     *
     * @return
     * @throws Exception
     */
    AppNoticeDetailVo getLatestAppNotice() throws Exception;

    /**
     * APP公告分页列表
     *
     * @param appNoticeRequest
     * @return
     * @throws Exception
     */
    Paging<AppNoticeResponse> getAppNoticeList(AppNoticeRequest appNoticeRequest) throws Exception;

}
